Oracle Diagnostic Loggingの使用
6-2 Oracle HTTP Server管理者ガイド
Oracle Diagnostic Logging の使用 の使用 の使用 の使用
Oracleでは、診断メッセージの報告のために新しい方法を提供しています。この新しい方法
はOracle Diagnostic Logging（ODL）と呼ばれ、診断メッセージとログ・ファイルのための
共通形式と、Oracle Database全体の様々なコンポーネントからの全診断メッセージを相互 に関係付ける仕組みを提供しています。ODLを使用して、各コンポーネントはそのコン ポーネント専用のプライベート・ローカル・リポジトリにそれぞれのメッセージをログしま す。LogLoaderというツールが、各リポジトリからメッセージを収集して共通リポジトリ にロードします。メッセージは、この共通リポジトリで1つのログ・ストリームとして表示 するか、様々な方法で分析できます。
Oracle Databaseの診断ログ・ファイルは、テキスト・エディタを使用して表示できます。
概要 概要 概要 概要
Oracle HTTP Serverでは、ログ・メッセージを生成する書式を選択できます。従来型の
Apacheメッセージ形式でログ・メッセージを生成するか、ODLを使用してログ・メッセー
ジの生成を続行できます。ODLは、ログ・メッセージ生成用の新しいOracle標準に準拠し ています。
Oracle HTTP Server の構成 の構成 の構成 の構成
Oracle HTTP ServerでODLを使用可能にするには、httpd.confファイルに次の項で指定
されているディレクティブを入力します。モジュール固有のログ重大度が有効化してからモ ジュールがロギングを実行するように、これらのディレクティブは、httpd.confファイル でなんらかのモジュールがロードされる前に（LoadModuleディレクティブの前に）指定す ることをお薦めします。
Oracle Diagnostic Loggingの使用
サーバー・ログの構成と使用 6-3 module_name
この引数は、モジュール構造内に示されるモジュールの内部名です。<IfModule>ディレク ティブもこの内部名を使用します。モジュール構造は、モジュール構造を定義するファイル の_FILE_マクロの値から（パス接頭辞を削除して）モジュール名を導出します。モジュー ル名を指定しない場合は、OraLogSeverityディレクティブがグローバルに適用されます。
モジュール名を指定した場合は、指定されたモジュールで発生した、すべてのメッセージの グローバル・ディレクティブの値をこのディレクティブがオーバーライドします。ロードさ れないモジュールの名前を指定すると、エラーが発生します。
msg_type
メッセージ・タイプは大文字でも小文字でも指定できますが、メッセージ出力は大文字で表 示されます。このパラメータには、次の値のいずれかを指定する必要があります。
■ INTERNAL_ERROR
■ ERROR
■ WARNING
■ NOTIFICATION
■ TRACE
msg_level
このパラメータは、範囲が1～32の整数に指定する必要があります。
OraLogSeverityの例をいくつか表6-1に示します。
表 表表
表 6-1 OraLogSeverityの例の例の例の例
OraLogSeverityの例の例の例の例 処理処理処理処理 OraLogSeverity INTERNAL_
ERROR:10
レベル1～10の内部エラー（INTERNAL_ERROR）タイプ のメッセージをすべてログします。
OraLogSeverity WARNING:7 全レベルの内部エラー（INTERNAL_ERROR）タイプのメッ セージをすべてログします。
全レベルのエラー（ERROR）タイプのメッセージをすべて ログします。
レベル1～7の警告（WARNING）タイプのメッセージをす
べてログします。
Oracle Diagnostic Loggingの使用
6-4 Oracle HTTP Server管理者ガイド デフォルト デフォルトデフォルト デフォルト
メッセージ・レベルを指定しない場合、レベルはデフォルトの最低重大度になります。ディ レクティブ全体を指定しない場合、グローバルなApacheのLogLevelディレクティブの値 が使用され、表6-2に示されるように、これに対応するOracleメッセージ・タイプおよび対 応する範囲内の最低レベル（最高値）に変換されます。
OraLogDir <bus stop dir>
すべてのログ・ファイルを含むディレクトリへのパスを指定します。このディレクトリは存 在している必要があります。
デフォルト デフォルトデフォルト デフォルト:
■ UNIXの場合: ORACLE_HOME/Apache/Apache/logs/oracle
■ Windowsの場合: ORACLE_HOME¥Apache¥Apache¥logs¥oracle
OraLogSeverity WARNING メッセージがその他のソースからの場合:
■ 全レベルの内部エラー（INTERNAL_ERROR）タイプの メッセージをすべてログします。
■ 全レベルのエラー（ERROR）タイプのメッセージをすべて ログします。
■ 全レベルの警告（WARNING）タイプのメッセージをすべ てログします。
表 表表
表 6-2 Apacheログ・レベルとログ・レベルとログ・レベルとログ・レベルとOracleメッセージ・タイプの対応メッセージ・タイプの対応メッセージ・タイプの対応メッセージ・タイプの対応
Apacheログ・レベルログ・レベルログ・レベルログ・レベル Oracleメッセージ・タイプメッセージ・タイプメッセージ・タイプメッセージ・タイプ
emerg INTERNAL_ERROR:16
alert INTERNAL_ERROR:32
crit ERROR:16
error ERROR:32
warn WARNING:32
notice NOTIFICATION:16
info NOTIFICATION:32
debug TRACE:32
関連項目 関連項目関連項目
関連項目: 6-5ページ「ログ・レベルの指定」
表 表表
表 6-1 OraLogSeverityの例の例の例の例
OraLogSeverityの例の例の例の例 処理処理処理処理
ログ・レベルの指定
サーバー・ログの構成と使用 6-5
ログの書式指定 ログの書式指定 ログの書式指定 ログの書式指定
LogFormatを使用して、ログ・ファイルに含める情報と書込み方法を指定します。デフォ ルトの書式はCommon Log Format（CLF）です。 CLF書式はhost ident authuser date request status bytesです。
■ host: クライアントのドメイン名またはIPアドレス。
■ ident: IdentityCheckが有効化されており、クライアント・マシンでidentdが実行 されている場合のクライアント識別情報。
■ authuser: 許可されたユーザーのユーザーID。
■ date: <day/month/year:hour:minute:second>書式のリクエスト日時。
■ request: 二重引用符で囲まれたクライアントからのリクエスト行。
■ status: クライアントに戻される3桁のステータス・コード。
■ bytes: クライアントに戻されるバイト数（ヘッダーを除く）。
ログ・レベルの指定 ログ・レベルの指定 ログ・レベルの指定 ログ・レベルの指定
表6-3に、様々なログ・レベル、説明およびメッセージの例を示します。
表 表表
表 6-3 ログ・レベルログ・レベルログ・レベルログ・レベル ログ・レベル ログ・レベルログ・レベル
ログ・レベル 説明説明説明説明 メッセージの例メッセージの例メッセージの例メッセージの例
Emergency 緊急 - システムは使用不可です。 "Child cannot open lock file. Exiting."
Alert ただちに処理する必要があります。 "getpwuid: couldn't determine user name from uid"
Critical 重大条件。 "socket: Failed to get a socket, exiting child"
Error エラー条件。 "Premature end of script headers"
Warning 警告条件。 "child process 1234 did not exit, sending another SIGHUP"
Notice 正常だが重要な条件。 "httpd: caught SIGBUS, attempting to dump core in..."
Information 可能性のある問題とそれに対して
可能な解決策を記述する情報メッ セージ。
"Server seems busy, (you may need to increase StartServers, or
Min/MaxSpareServers)..."
Debug デバッグ・レベルのメッセージ。 "Opening config file..."
ログ・ファイルの指定
6-6 Oracle HTTP Server管理者ガイド
ログ・ファイルの指定 ログ・ファイルの指定 ログ・ファイルの指定 ログ・ファイルの指定
次の項では、次のログ・ファイルについて説明します。
■ アクセス・ログ